home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d5 / speech.arc / TQUERY.DOC < prev    next >
Encoding:
Text File  |  1991-03-16  |  7.6 KB  |  183 lines
  1.               TQuery 1.0.0
  2.           Quick and dirty documentation
  3.           <c> 1986 Michael B. Garrett/WAO Labs
  4.  
  5. TQuery is simple telephone database that talks. It is intended to
  6. be  used  by  the visually impaired individual    that  needs  easy
  7. access to large amounts of name/number type data.
  8.  
  9. The  actual  'speaking'  subroutine and alphabet was found  in  a
  10. public-domain  program    called 'TALKER.BAS' downloaded  from  the
  11. RBBS in Durham,  NC 919-471-5918 (Dan Delius,  Sysop).    As I  was
  12. enchanted  with  the quick and dirty method used by some  unknown
  13. programmer  to    output digital recordings stored  as  strings,    I
  14. decided to put the routine to work,  so to speak.  The result  is
  15. TQuery.
  16.  
  17. To use TQuery:
  18. --------------
  19. First  make sure that the  files  "TQUERY.BAS",  "LOGO.ZAP",  and
  20. "PHONE.DAT"  reside  on  the same disk.  If you use a  disk  that
  21. contains  only the system,  BASICA or equivalent,  and the  files
  22. mentioned above,  you'll have room enough for at least 5000 names
  23. and numbers at a rough guess. In other words, more than enough.
  24.  
  25. To  execute the program,  type "BASICA {or  equivalent}  TQUERY".
  26. After  seeing the signon and logo,  your computer will say  'OK'.
  27. Also, the prompt "Query:" will be displayed.
  28.  
  29. There are 2 phone numbers already in TQuery's database. The first
  30. is the number for International Bancorp in Raleigh,  NC,  where I
  31. can  be  contacted.  The  second is the number for  the  RBBS  in
  32. Durham,   where   those  interested  may  download  the   program
  33. "TALKER.BAS"  and  also a standard Query- as well as  many  other
  34. good public-domain and freeware programs.
  35.  
  36. The  names  assigned  these  numbers are  'Darkshot'  and  'RBBS'
  37. respectively.
  38.  
  39. Type 'RBBS' at the Query:  prompt.  After a disk access, you will
  40. hear  spoken  from  your PC's speaker "919  {pause}  471  {pause}
  41. 5918".  In other words,  enter the name and hear the number.  You
  42. will  notice as you enter the name that each letter is spoken  as
  43. you  type it.  Also notice that the screen displays the name  and
  44. number as it is being spoken. The backspace key will 'feep' as it
  45. as  pressed  during entry,  and one letter will be  removed  from
  46. input each time. At any point you wish to have all the letters in
  47. the input line to be spoken, (in case you aren't sure how far you
  48. backspaced) press the "/" key. Each letter in the input line will
  49. be  spoken  and then you may edit as necessary.  If  you  hear    a
  50. "BEEP",  you  have either backspaced to the beginning or you have
  51. filled    the input line.  Inputs are limited to 20 characters  for
  52. both name and number.
  53.  
  54. After each name is displayed and the number is spoken,    you  will
  55. hear a "gleep" (AKA a  'climbing feep').  At this point,  you may
  56. press  the  spacebar for the next number that matches your  input
  57. search key (if another exists) or to return you to 'OK'  {spoken}
  58. and 'Query:' {displayed} if you are at the end of your data.  ANY
  59. OTHER  KEY that is pressed at this point will cause the  spelling
  60. out of each letter in the name, followed by the number.
  61.  
  62. In use it would go like this:
  63.  
  64. Query: RBBS
  65. <CR> feep.
  66. Displayed- RBBS     919-471-5918
  67. Spoken- 919 {p} 471 {p} 5918
  68. gleep
  69. <SPACEBAR>
  70. Spoken- OK
  71. Displayed- Query:
  72. Query: RBBS
  73. <CR> feep.
  74. Displayed- RBBS     919-471-5918
  75. Spoken- 919 {p} 471 {p} 5918
  76. gleep
  77. <CR> (or any key other than spacebar)
  78. Display- no change.
  79. Spoken- RBBS {p} 919 {p} 471 {p} 5918
  80. gleep
  81. <SPACEBAR>
  82. Spoken- OK
  83. Displayed- Query:
  84.  
  85. To add a name and number to TQuery:
  86. -----------------------------------
  87.  
  88. At the Query: prompt, hit '+'.
  89. TQuery    will  display the prompt "Name:" and speak  "W-H-O"  (one
  90. letter at a time).
  91.  
  92. At this point, enter the name.
  93.  
  94. TQuery will respond by displaying "Tel#:" and will speak "N-U-M".
  95. Enter the number. Be advised that spaces or "-"'s in either input
  96. will  translate as pauses in the spoken output,  which is  as  it
  97. should be.
  98.  
  99. That's  all there is- after storing your data TQuery will display
  100. the "Query:" prompt and say 'OK'.  It is then ready to respond to
  101. the next action.
  102.  
  103. To exit TQuery, simply answer the Query: prompt with "EXIT".
  104.  
  105. Special Programmer's Notes:
  106. ---------------------------
  107.  
  108. I  didn't  write  the machine  language   routine  that  actually
  109. 'speaks'  the string (stored in HELLO$ and in array A$(),  and  I
  110. haven't  yet dug into it so I can be of little help right now  in
  111. understanding its operation.  However, upon examination by myself
  112. and James Kirby of WAO Labs,  the strings were found to graph out
  113. to a perfect replica of digitized speech.  Basically,  we wrote a
  114. program  to  draw  a  line as long as the  ascii  value  for  the
  115. particular  byte  in a string.    After setting up  parameters  for
  116. lows,  mids and highs (white,  blue,  purple) we were left with a
  117. display  remarkably  similar  to that of a  Sony  digital  studio
  118. recorder, albeit with very little frequence response, which is to
  119. be  expected.  It seems to us that a program to edit waveforms on
  120. the fly,  with instant feedback,  would be a simple prospect.  In
  121. this way we hope to create words- and using the 64 or so standard
  122. noises in English (I think they call them phenomes or something),
  123. a  text to speech program is a simple prospect as  well.  All  in
  124. BASICA, no less.
  125.  
  126. At any rate,  it interests me.    If the programmer that originally
  127. created the machine language program contained in "TALKER.BAS" is
  128. still  around,    I'd like to get in touch with him/her.  WAO's use
  129. for 8088 machine code is zero,    and so is my inclination to learn
  130. it,  but this routine is limited and could be improved greatly by
  131. some  of WAO's off-the-shelf magic,  if we knew where  the  hooks
  132. were. We've been turning IBM's into real computers for years.....
  133.  
  134.  
  135. The Freeware Concept:
  136. ---------------------
  137.  
  138. So  much  pompous  noise has been preached about the  concept  of
  139. "FREEWARE"  (which,   ludicrously  enough  is  rumored  to  be  a
  140. registered  trade-mark- people    continue to amaze me  with  their
  141. stupidity) that I won't add to the hot air here.
  142.  
  143. Inasmuch  as  I didn't create the entire  program  from  scratch,
  144. morally  I  can't charge anything for it.  (Morals I believe  in-
  145. laws  I  consider trivia.) Those few that know me will attest  to
  146. the fact that I am not motivated by any altruistic tendencies, as
  147. well.  I wrote this program because it interested me- and I spent
  148. a grand total of about 1 hour on its design.
  149.  
  150. So:
  151.  
  152. I included a number to reach me in the database contained herein.
  153. If  somehow this program  outlives the RBBS in Durham,    I can  be
  154. contacted  at the number for Bancorp.  I would prefer that  I  be
  155. contacted  by  E-mail  on  the BBS,  but I do want  to    hear  any
  156. suggestions,  ideas  for special configurations,  and  especially
  157. from  the  original  programmer of the    8088  code  contained  in
  158. TQuery.  It's  a nice piece of work- in an age of mediocrity,  no
  159. less.
  160.  
  161. TQUERY is copyright 1986 Michael B. Garrett/WAO Labs
  162. All rights reserved.
  163.  
  164. This is done to prevent some clown from marketing TQUERY.  If you
  165. don't think that an "OK" idea and quick and dirty implementation,
  166. completely  shot through with bugs and simply lousy code  can  be
  167. turned     into  'product'  and  sold  to  the  unsuspecting  idiot
  168. consumers, I suggest you take a look at Mind Prober.
  169.  
  170. TQuery was written as free software and it shall remain as such.
  171.  
  172. If, somehow, this program finds its way into the hands of someone
  173. who can benefit from it, that is payment enough- although I would
  174. appreciate  it    if users would contact me- if only to  track  the
  175. freeware net in action.
  176.  
  177. Thus proclaimed from the Realm of Darkshot, Sunday Jan 19, 1986.
  178.  
  179. Michael B. Garrett
  180. Terylea Patton
  181. James Kirby
  182. Patrick Jones
  183.